home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmManager.z / XmManager
Encoding:
Text File  |  2003-11-18  |  28.6 KB  |  661 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_M_a_n_a_g_e_r - The Manager widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       #include <Xm/Xm.h>
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.       Manager is a widget class used as a supporting superclass
  16.       for other widget classes.  It    supports the visual resources,
  17.       graphics contexts, and traversal resources necessary for the
  18.       graphics and traversal mechanisms.
  19.  
  20.     CCCCllllaaaasssssssseeeessss
  21.       Manager inherits behavior and    resources from _C_o_r_e,
  22.       _C_o_m_p_o_s_i_t_e, and _C_o_n_s_t_r_a_i_n_t classes.
  23.  
  24.       The class pointer is _x_m_M_a_n_a_g_e_r_W_i_d_g_e_t_C_l_a_s_s.
  25.  
  26.       The class name is _X_m_M_a_n_a_g_e_r.
  27.  
  28.     NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  29.       The following    table defines a    set of widget resources    used
  30.       by the programmer to specify data.  The programmer can also
  31.       set the resource values for the inherited classes to set
  32.       attributes for this widget.  To reference a resource by name
  33.       or by    class in a .Xdefaults file, remove the _X_m_N or _X_m_C
  34.       prefix and use the remaining letters.     To specify one    of the
  35.       defined values for a resource    in a .Xdefaults    file, remove
  36.       the _X_m prefix    and use    the remaining letters (in either
  37.       lowercase or uppercase, but include any underscores between
  38.       words).  The codes in    the access column indicate if the
  39.       given    resource can be    set at creation    time (C), set by using
  40.       _X_t_S_e_t_V_a_l_u_e_s (S), retrieved by    using _X_t_G_e_t_V_a_l_u_e_s (G), or is
  41.       not applicable (N/A).
  42.  
  43.                       XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  44.      NNNNaaaammmmeeee             CCCCllllaaaassssssss             TTTTyyyyppppeeee         DDDDeeeeffffaaaauuuulllltttt        AAAAcccccccceeeessssssss
  45.      _________________________________________________________________________________________________
  46.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel         dynamic        CSG
  47.      XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap         XmUNSPECIFIED_PIXMAP    CSG
  48.      XmNforeground         XmCForeground         Pixel         dynamic        CSG
  49.      XmNhelpCallback         XmCCallback         XtCallbackList     NULL            C
  50.      XmNhighlightColor         XmCHighlightColor         Pixel         dynamic        CSG
  51.      XmNhighlightPixmap         XmCHighlightPixmap         Pixmap         dynamic        CSG
  52.      XmNinitialFocus         XmCInitialFocus         Widget         NULL            CSG
  53.      XmNnavigationType         XmCNavigationType         XmNavigationType     XmTAB_GROUP        CSG
  54.      XmNshadowThickness         XmCShadowThickness         Dimension         0            CSG
  55.      XmNstringDirection         XmCStringDirection         XmStringDirection     dynamic        CG
  56.      XmNtopShadowColor         XmCTopShadowColor         Pixel         dynamic        CSG
  57.      XmNtopShadowPixmap         XmCTopShadowPixmap         Pixmap         dynamic        CSG
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      XmNtraversalOn         XmCTraversalOn         Boolean         True            CSG
  75.      XmNunitType         XmCUnitType         unsigned char     dynamic        CSG
  76.      XmNuserData         XmCUserData         XtPointer         NULL            CSG
  77.  
  78.  
  79.       _X_m_N_b_o_t_t_o_m_S_h_a_d_o_w_C_o_l_o_r
  80.            Specifies the color to use to draw the bottom and right
  81.            sides of    the border shadow.  This color is used if the
  82.            _X_m_N_b_o_t_t_o_m_S_h_a_d_o_w_P_i_x_m_a_p resource is NULL.
  83.  
  84.       _X_m_N_b_o_t_t_o_m_S_h_a_d_o_w_P_i_x_m_a_p
  85.            Specifies the pixmap to use to draw the bottom and
  86.            right sides of the border shadow.
  87.  
  88.       _X_m_N_f_o_r_e_g_r_o_u_n_d
  89.            Specifies the foreground    drawing    color used by manager
  90.            widgets.
  91.  
  92.       _X_m_N_h_e_l_p_C_a_l_l_b_a_c_k
  93.            Specifies the list of callbacks that are    called when
  94.            the help    key sequence is    pressed.  The reason sent by
  95.            this callback is    _X_m_C_R__H_E_L_P.
  96.  
  97.       _X_m_N_h_i_g_h_l_i_g_h_t_C_o_l_o_r
  98.            Specifies the color of the highlighting rectangle.
  99.            This color is used if the highlight pixmap resource is
  100.            _X_m_U_N_S_P_E_C_I_F_I_E_D__P_I_X_M_A_P.
  101.  
  102.       _X_m_N_h_i_g_h_l_i_g_h_t_P_i_x_m_a_p
  103.            Specifies the pixmap used to draw the highlighting
  104.            rectangle.
  105.  
  106.       _X_m_N_i_n_i_t_i_a_l_F_o_c_u_s
  107.            Specifies the ID    of a widget descendant of the manager.
  108.            The widget must meet these conditions:
  109.  
  110.       +o    The widget must be either a tab group or    a non-tab-
  111.            group widget that can receive keyboard focus.  For the
  112.            definition of a tab group, see the description of the
  113.            Manager,    Primitive, and Gadget _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_e
  114.            resources.  In general a    widget can receive keyboard
  115.            focus when it is    a primitive, a gadget, or a manager
  116.            (such as    a DrawingArea with no traversable children)
  117.            that acts as a primitive.
  118.  
  119.       +o    The widget must not be a    descendant of a    tab group that
  120.            is itself a descendant of the manager.  That is,    the
  121.            widget cannot be    contained within a tab group that is
  122.            nested inside the manager.
  123.  
  124.       +o    The widget and its ancestors must have a    value of True
  125.            for their _X_m_N_t_r_a_v_e_r_s_a_l_O_n    resources.
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  137.  
  138.  
  139.  
  140.            If the widget does not meet these conditions,
  141.            _X_m_N_i_n_i_t_i_a_l_F_o_c_u_s is treated as if    the value were NULL.
  142.  
  143.            This resource is    meaningful only    when the nearest shell
  144.            ancestor's _X_m_N_k_e_y_b_o_a_r_d_F_o_c_u_s_P_o_l_i_c_y is _X_m_E_X_P_L_I_C_I_T.     It is
  145.            used to determine which widget receives focus in    these
  146.            situations:
  147.  
  148.       +o    When the    manager    is the child of    a shell    and the    shell
  149.            hierarchy receives focus    for the    first time
  150.  
  151.       +o    When focus is inside the    shell hierarchy, the manager
  152.            is a composite tab group, and the user traverses    to the
  153.            manager via the keyboard
  154.  
  155.            Focus is    then determined    as follows:
  156.  
  157.       +o    If _X_m_N_i_n_i_t_i_a_l_F_o_c_u_s is a traversable non-tab-group
  158.            widget, that widget receives focus.
  159.  
  160.       +o    If _X_m_N_i_n_i_t_i_a_l_F_o_c_u_s is a traversable tab group, that tab
  161.            group receives focus.  If that tab group    is a composite
  162.            with descendant tab groups or traversable non-tab-group
  163.            widgets,    these procedures are used recursively to
  164.            assign focus to a descendant of that tab    group.
  165.  
  166.       +o    If _X_m_N_i_n_i_t_i_a_l_F_o_c_u_s is NULL, the first traversable non-
  167.            tab-group widget    that is    not contained within a nested
  168.            tab group receives focus.
  169.  
  170.       +o    If _X_m_N_i_n_i_t_i_a_l_F_o_c_u_s is NULL and no traversable non-tab-
  171.            group widget exists, the    first traversable tab group
  172.            that is not contained within a nested tab group
  173.            receives    focus.    If that    tab group is a composite with
  174.            descendant tab groups or    traversable non-tab-group
  175.            widgets,    these procedures are used recursively to
  176.            assign focus to a descendant of that tab    group.
  177.  
  178.            If a shell hierarchy regains focus after    losing it,
  179.            focus returns to    the widget that    had the    focus at the
  180.            time it left the    hierarchy.
  181.  
  182.            The use of _X_m_N_i_n_i_t_i_a_l_F_o_c_u_s is undefined if the manager
  183.            is a MenuBar, PulldownMenu, PopupMenu, or OptionMenu.
  184.  
  185.       _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_e
  186.            Determines whether the widget is    a tab group.
  187.  
  188.       +o    _X_m_N_O_N_E indicates    that the widget    is not a tab group.
  189.  
  190.       +o    _X_m_T_A_B__G_R_O_U_P indicates that the widget is    a tab group,
  191.            unless another widget in    the hierarchy has an
  192.  
  193.  
  194.  
  195.      Page 3                        (printed 11/11/03)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  203.  
  204.  
  205.  
  206.            _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_e of _X_m_E_X_C_L_U_S_I_V_E__T_A_B__G_R_O_U_P.
  207.  
  208.       +o    _X_m_S_T_I_C_K_Y__T_A_B__G_R_O_U_P indicates that the widget is a tab
  209.            group, even if another widget in    the hierarchy has an
  210.            _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_e of _X_m_E_X_C_L_U_S_I_V_E__T_A_B__G_R_O_U_P.
  211.  
  212.       +o    _X_m_E_X_C_L_U_S_I_V_E__T_A_B__G_R_O_U_P indicates that the    widget is a
  213.            tab group and that widgets in the hierarchy whose
  214.            _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_e is _X_m_T_A_B__G_R_O_U_P    are not    tab groups.
  215.  
  216.            When a parent widget has    an _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_e of
  217.            _X_m_E_X_C_L_U_S_I_V_E__T_A_B__G_R_O_U_P, traversal    of non-tab-group
  218.            widgets within the group    is based on the    order of those
  219.            widgets in their    parent's _X_m_N_c_h_i_l_d_r_e_n list.
  220.  
  221.            When any    widget in a hierarchy has an _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_e
  222.            of _X_m_E_X_C_L_U_S_I_V_E__T_A_B__G_R_O_U_P, traversal of tab groups in
  223.            the hierarchy proceeds to widgets in the    order in which
  224.            their _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_e resources were specified    as
  225.            _X_m_E_X_C_L_U_S_I_V_E__T_A_B__G_R_O_U_P or    _X_m_S_T_I_C_K_Y__T_A_B__G_R_O_U_P, whether by
  226.            creating    the widgets with that value, by    calling
  227.            _X_t_S_e_t_V_a_l_u_e_s, or by calling _X_m_A_d_d_T_a_b_G_r_o_u_p.
  228.  
  229.       _X_m_N_s_h_a_d_o_w_T_h_i_c_k_n_e_s_s
  230.            Specifies the thickness of the drawn border shadow.
  231.            _X_m_B_u_l_l_e_t_i_n_B_o_a_r_d and its descendants set this value
  232.            dynamically.  If    the widget is a    top level window, this
  233.            value is    set to 1.  If it is not    a top level window,
  234.            this value is set to 0.
  235.  
  236.       _X_m_N_s_t_r_i_n_g_D_i_r_e_c_t_i_o_n
  237.            Specifies the initial direction to draw strings.     The
  238.            values are _X_m_S_T_R_I_N_G__D_I_R_E_C_T_I_O_N__L__T_O__R and
  239.            _X_m_S_T_R_I_N_G__D_I_R_E_C_T_I_O_N__R__T_O__L.  The value of    this resource
  240.            is determined at    creation time.    If the widget's    parent
  241.            is a manager, this value    is inherited from the widget's
  242.            parent, otherwise it is set to
  243.            _X_m_S_T_R_I_N_G__D_I_R_E_C_T_I_O_N__L__T_O__R.
  244.  
  245.       _X_m_N_t_o_p_S_h_a_d_o_w_C_o_l_o_r
  246.            Specifies the color to use to draw the top and left
  247.            sides of    the border shadow.  This color is used if the
  248.            _X_m_N_t_o_p_S_h_a_d_o_w_P_i_x_m_a_p resource is NULL.
  249.  
  250.       _X_m_N_t_o_p_S_h_a_d_o_w_P_i_x_m_a_p
  251.            Specifies the pixmap to use to draw the top and left
  252.            sides of    the border shadow.
  253.  
  254.       _X_m_N_t_r_a_v_e_r_s_a_l_O_n
  255.            Specifies whether traversal is activated    for this
  256.            widget.
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                        (printed 11/11/03)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  269.  
  270.  
  271.  
  272.       _X_m_N_u_n_i_t_T_y_p_e
  273.            Provides    the basic support for resolution independence.
  274.            It defines the type of units a widget uses with sizing
  275.            and positioning resources.  If the widget's parent is a
  276.            subclass    of _X_m_M_a_n_a_g_e_r and if the    _X_m_N_u_n_i_t_T_y_p_e resource
  277.            is not explicitly set, it defaults to the unit type of
  278.            the parent widget.  If the widget's parent is not a
  279.            subclass    of _X_m_M_a_n_a_g_e_r, the resource has a default unit
  280.            type of _X_m_P_I_X_E_L_S.
  281.  
  282.            _X_m_N_u_n_i_t_T_y_p_e can have the    following values:
  283.  
  284.       +o    _X_m_P_I_X_E_L_S    - all values provided to the widget are
  285.            treated as normal pixel values.
  286.  
  287.       +o    _X_m_1_0_0_T_H__M_I_L_L_I_M_E_T_E_R_S - all values    provided to the    widget
  288.            are treated as 1/100 millimeter.
  289.  
  290.       +o    _X_m_1_0_0_0_T_H__I_N_C_H_E_S - all values provided to    the widget are
  291.            treated as 1/1000 inch.
  292.  
  293.       +o    _X_m_1_0_0_T_H__P_O_I_N_T_S -    all values provided to the widget are
  294.            treated as 1/100    point.    A point    is a unit used in text
  295.            processing applications and is defined as 1/72 inch.
  296.  
  297.       +o    _X_m_1_0_0_T_H__F_O_N_T__U_N_I_T_S - all    values provided    to the widget
  298.            are treated as 1/100 of a font unit.  A font unit has
  299.            horizontal and vertical components.  These are the
  300.            values of the XmScreen resources    _X_m_N_h_o_r_i_z_o_n_t_a_l_F_o_n_t_U_n_i_t
  301.            and _X_m_N_v_e_r_t_i_c_a_l_F_o_n_t_U_n_i_t.
  302.  
  303.       _X_m_N_u_s_e_r_D_a_t_a
  304.            Allows the application to attach    any necessary specific
  305.            data to the widget.  This is an internally unused
  306.            resource.
  307.  
  308.     DDDDyyyynnnnaaaammmmiiiicccc    CCCCoooolllloooorrrr DDDDeeeeffffaaaauuuullllttttssss
  309.       The foreground, background, top shadow, bottom shadow, and
  310.       highlight color resources are    dynamically defaulted.    If no
  311.       color    data is    specified, the colors are automatically
  312.       generated.  On a single-plane    system,    a black    and white
  313.       color    scheme is generated.  Otherwise, four colors are
  314.       generated, which display the correct shading for the 3-D
  315.       visuals.  If the background is the only color    specified for
  316.       a widget, the    top shadow and bottom shadow colors are
  317.       generated to give the    3-D appearance.     Foreground and
  318.       highlight colors are generated to provide sufficient
  319.       contrast with    the background color.
  320.  
  321.            Colors are generated only at creation.  Resetting the
  322.            background through _X_t_S_e_t_V_a_l_u_e_s does not regenerate the
  323.            other colors.  _X_m_C_h_a_n_g_e_C_o_l_o_r can    be used    to recalculate
  324.  
  325.  
  326.  
  327.      Page 5                        (printed 11/11/03)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  335.  
  336.  
  337.  
  338.            all associated colors based on a    new background color.
  339.  
  340.     IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  341.       Manager inherits the following resources from    the named
  342.       superclasses.     For a complete    description of each resource,
  343.       refer    to the man page    for that superclass.
  344.  
  345.                  CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee    SSSSeeeetttt
  346.      NNNNaaaammmmeeee         CCCCllllaaaassssssss             TTTTyyyyppppeeee       DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  347.      ______________________________________________________________________
  348.      XmNchildren     XmCReadOnly         WidgetList       NULL         G
  349.      XmNinsertPosition     XmCInsertPosition   XtOrderProc   NULL         CSG
  350.      XmNnumChildren     XmCReadOnly         Cardinal       0         G
  351.  
  352.  
  353.                            CCCCoooorrrreeee    RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  354.      NNNNaaaammmmeeee                 CCCCllllaaaassssssss                 TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt             AAAAcccccccceeeessssssss
  355.      ______________________________________________________________________________________________________________
  356.      XmNaccelerators             XmCAccelerators             XtAccelerators   dynamic             CSG
  357.      XmNancestorSensitive         XmCSensitive             Boolean          dynamic             G
  358.      XmNbackground             XmCBackground             Pixel          dynamic             CSG
  359.      XmNbackgroundPixmap         XmCPixmap                 Pixmap          XmUNSPECIFIED_PIXMAP   CSG
  360.      XmNborderColor             XmCBorderColor             Pixel          XtDefaultForeground    CSG
  361.      XmNborderPixmap             XmCPixmap                 Pixmap          XmUNSPECIFIED_PIXMAP   CSG
  362.      XmNborderWidth             XmCBorderWidth             Dimension          0                 CSG
  363.      XmNcolormap             XmCColormap             Colormap          dynamic             CG
  364.      XmNdepth                 XmCDepth                 int          dynamic             CG
  365.      XmNdestroyCallback             XmCCallback             XtCallbackList   NULL             C
  366.      XmNheight                 XmCHeight                 Dimension          dynamic             CSG
  367.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True             C
  368.      XmNmappedWhenManaged         XmCMappedWhenManaged         Boolean          True             CSG
  369.      XmNscreen                 XmCScreen                 Screen *          dynamic             CG
  370.      XmNsensitive             XmCSensitive             Boolean          True             CSG
  371.      XmNtranslations             XmCTranslations             XtTranslations   dynamic             CSG
  372.      XmNwidth                 XmCWidth                 Dimension          dynamic             CSG
  373.      XmNx                 XmCPosition             Position          0                 CSG
  374.      XmNy                 XmCPosition             Position          0                 CSG
  375.  
  376.  
  377.     CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  378.       A pointer to the following structure is passed to each
  379.       callback:
  380.       typedef struct
  381.       {
  382.         int         rrrreeeeaaaassssoooonnnn;
  383.         _X_E_v_e_n_t     **** eeeevvvveeeennnntttt;
  384.       } _X_m_A_n_y_C_a_l_l_b_a_c_k_S_t_r_u_c_t;
  385.  
  386.       rrrreeeeaaaassssoooonnnn
  387.            Indicates why the callback was invoked.    For this
  388.            callback, rrrreeeeaaaassssoooonnnn    is set to _X_m_C_R__H_E_L_P.
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                        (printed 11/11/03)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  401.  
  402.  
  403.  
  404.       eeeevvvveeeennnntttt
  405.            Points to the _X_E_v_e_n_t that triggered the callback.
  406.  
  407.     TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  408.       The following    set of translations are    used by    Manager
  409.       widgets that have Gadget children.  Since Gadgets cannot
  410.       have translations associated with them, it is    the
  411.       responsibility of the    Manager    widget to intercept the    events
  412.       of interest and pass them to any Gadget child    with focus.
  413.       These    events are ignored if no Gadget    child has the focus.
  414.       Some of these    translations may be affected by    the
  415.       XmDisplay's _e_n_a_b_l_e_M_u_l_t_i_K_e_y_B_i_n_d_i_n_g_s resource: see
  416.       XmDisplay(3X).  These    translations may not directly
  417.       correspond to    a translation table.
  418.       BAny Motion:     ManagerGadgetButtonMotion()
  419.       BSelect Press: ManagerGadgetArm()
  420.       BSelect Click: ManagerGadgetActivate()
  421.       BSelect Release:ManagerGadgetActivate()
  422.       BSelect Press    2+:ManagerGadgetMultiArm()
  423.       BSelect Release 2+:ManagerGadgetMultiActivate()
  424.       BDrag    Press:     ManagerGadgetDrag()
  425.  
  426.       KSelect:     ManagerGadgetSelect()
  427.       KActivate:     ManagerParentActivate()
  428.  
  429.       KCancel:     ManagerParentCancel()
  430.  
  431.       KPrevField:     ManagerGadgetPrevTabGroup()
  432.       KNextField:     ManagerGadgetNextTabGroup()
  433.  
  434.       KUp:         ManagerGadgetTraverseUp()
  435.       KDown:     ManagerGadgetTraverseDown()
  436.       KLeft:     ManagerGadgetTraverseLeft()
  437.       KRight:     ManagerGadgetTraverseRight()
  438.  
  439.       KBeginLine:     ManagerGadgetTraverseHome()
  440.  
  441.       KHelp:     ManagerGadgetHelp()
  442.  
  443.       KAny:         ManagerGadgetKeyInput()
  444.  
  445.     AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss
  446.       The XmManager    action routines    are described below:
  447.  
  448.       _M_a_n_a_g_e_r_G_a_d_g_e_t_A_c_t_i_v_a_t_e():
  449.            Causes the current gadget to be activated.
  450.  
  451.       _M_a_n_a_g_e_r_G_a_d_g_e_t_A_r_m():
  452.            Causes the current gadget to be armed.
  453.  
  454.       _M_a_n_a_g_e_r_G_a_d_g_e_t_B_u_t_t_o_n_M_o_t_i_o_n():
  455.            Causes the current gadget to process a mouse motion
  456.  
  457.  
  458.  
  459.      Page 7                        (printed 11/11/03)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  467.  
  468.  
  469.  
  470.            event.
  471.  
  472.       _M_a_n_a_g_e_r_G_a_d_g_e_t_D_r_a_g():
  473.            Drags the contents of a gadget label, identified    by
  474.            pressing    _B_D_r_a_g.    This action creates a DragContext
  475.            object whose _X_m_N_e_x_p_o_r_t_T_a_r_g_e_t_s resource is set to
  476.            "COMPOUND_TEXT" for a label type    of _X_m_S_T_R_I_N_G;
  477.            otherwise, "PIXMAP" if the label    type is    _X_m_P_I_X_M_A_P.
  478.            This action is undefined    for gadgets used in a menu
  479.            system.
  480.  
  481.       _M_a_n_a_g_e_r_G_a_d_g_e_t_H_e_l_p():
  482.            Calls the callbacks for the current gadget's
  483.            _X_m_N_h_e_l_p_C_a_l_l_b_a_c_k if any exist.  If there are no help
  484.            callbacks for this widget, this action calls the    help
  485.            callbacks for the nearest ancestor that has them.
  486.  
  487.       _M_a_n_a_g_e_r_G_a_d_g_e_t_K_e_y_I_n_p_u_t():
  488.            Causes the current gadget to process a keyboard event.
  489.  
  490.       _M_a_n_a_g_e_r_G_a_d_g_e_t_M_u_l_t_i_A_c_t_i_v_a_t_e():
  491.            Causes the current gadget to process a multiple mouse
  492.            click.
  493.  
  494.       _M_a_n_a_g_e_r_G_a_d_g_e_t_M_u_l_t_i_A_r_m():
  495.            Causes the current gadget to process a multiple mouse
  496.            button press.
  497.  
  498.       _M_a_n_a_g_e_r_G_a_d_g_e_t_N_e_x_t_T_a_b_G_r_o_u_p():
  499.            This action depends on the value    of the XmDisplay
  500.            resource    _e_n_a_b_l_e_B_u_t_t_o_n_T_a_b.
  501.  
  502.            When _e_n_a_b_l_e_B_u_t_t_o_n_T_a_b is False (the default), this
  503.            action traverses    to the first item in the next tab
  504.            group.  If the current tab group    is the last entry in
  505.            the tab group list, it wraps to the beginning of    the
  506.            tab group list.
  507.  
  508.            When _e_n_a_b_l_e_B_u_t_t_o_n_T_a_b is True, this action will move to
  509.            the next    item within the    current    tab group unless it is
  510.            the last    item in    the tab    group.    When the item is the
  511.            last in the group, the action traverses to the first
  512.            item in the next    tab group.  The    _e_n_a_b_l_e_B_u_t_t_o_n_T_a_b
  513.            behavior    applies    only to    XmPushButton, XmArrow, and
  514.            XmDrawnButton.
  515.  
  516.       _M_a_n_a_g_e_r_G_a_d_g_e_t_P_r_e_v_T_a_b_G_r_o_u_p():
  517.            This action depends on the value    of the XmDisplay
  518.            resource    _e_n_a_b_l_e_B_u_t_t_o_n_T_a_b.
  519.  
  520.            When _e_n_a_b_l_e_B_u_t_t_o_n_T_a_b is False (the default), this
  521.            action traverses    to the first item in the previous tab
  522.  
  523.  
  524.  
  525.      Page 8                        (printed 11/11/03)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  533.  
  534.  
  535.  
  536.            group.  If the beginning    of the tab group list is
  537.            reached,    it wraps to the    end of the tab group list.
  538.  
  539.            When _e_n_a_b_l_e_B_u_t_t_o_n_T_a_b is True, this action will move to
  540.            the previous item within    the current tab    group unless
  541.            it is the first item in the tab group.  When the    item
  542.            is the first in the group, the action traverses to the
  543.            first item in the previous tab group.  The
  544.            _e_n_a_b_l_e_B_u_t_t_o_n_T_a_b behavior    applies    only to    XmPushButton,
  545.            XmArrow,    and XmDrawnButton.
  546.  
  547.       _M_a_n_a_g_e_r_G_a_d_g_e_t_S_e_l_e_c_t():
  548.            Causes the current gadget to be armed and activated.
  549.  
  550.       _M_a_n_a_g_e_r_G_a_d_g_e_t_T_r_a_v_e_r_s_e_D_o_w_n():
  551.            Traverses to the    next item below    the current gadget in
  552.            the current tab group, wrapping if necessary.
  553.  
  554.       _M_a_n_a_g_e_r_G_a_d_g_e_t_T_r_a_v_e_r_s_e_H_o_m_e():
  555.            Traverses to the    first widget or    gadget in the current
  556.            tab group.
  557.  
  558.       _M_a_n_a_g_e_r_G_a_d_g_e_t_T_r_a_v_e_r_s_e_L_e_f_t():
  559.            Traverses to the    next item to the left of the current
  560.            gadget in the current tab group,    wrapping if necessary.
  561.  
  562.       _M_a_n_a_g_e_r_G_a_d_g_e_t_T_r_a_v_e_r_s_e_N_e_x_t():
  563.            Traverses to the    next item in the current tab group,
  564.            wrapping    if necessary.
  565.  
  566.       _M_a_n_a_g_e_r_G_a_d_g_e_t_T_r_a_v_e_r_s_e_P_r_e_v():
  567.            Traverses to the    previous item in the current tab
  568.            group, wrapping if necessary.
  569.  
  570.       _M_a_n_a_g_e_r_G_a_d_g_e_t_T_r_a_v_e_r_s_e_R_i_g_h_t():
  571.            Traverses to the    next item to the right of the current
  572.            gadget in the current tab group,    wrapping if necessary.
  573.  
  574.       _M_a_n_a_g_e_r_G_a_d_g_e_t_T_r_a_v_e_r_s_e_U_p():
  575.            Traverses to the    next item above    the current gadget in
  576.            the current tab group, wrapping if necessary.
  577.  
  578.       _M_a_n_a_g_e_r_P_a_r_e_n_t_A_c_t_i_v_a_t_e():
  579.            If the parent is    a manager, passes the _K_A_c_t_i_v_a_t_e    event
  580.            received    by the current widget/gadget to    its parent.
  581.  
  582.       _M_a_n_a_g_e_r_P_a_r_e_n_t_C_a_n_c_e_l():
  583.            If the parent is    a manager, passes the _K_C_a_n_c_e_l event
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.      Page 9                        (printed 11/11/03)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  599.  
  600.  
  601.  
  602.            received    by the current widget/gadget to    its parent.
  603.  
  604.     AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
  605.       This widget has the additional behavior described below:
  606.  
  607.       <_F_o_c_u_s_I_n>:
  608.            If the shell's keyboard focus policy is _X_m_E_X_P_L_I_C_I_T and
  609.            the event occurs    in a gadget, causes the    gadget to be
  610.            highlighted and to take the focus.
  611.  
  612.       <_F_o_c_u_s_O_u_t>:
  613.            If the shell's keyboard focus policy is _X_m_E_X_P_L_I_C_I_T and
  614.            the event occurs    in a gadget, causes the    gadget to be
  615.            unhighlighted and to lose the focus.
  616.  
  617.     VVVViiiirrrrttttuuuuaaaallll    BBBBiiiinnnnddddiiiinnnnggggssss
  618.       The bindings for virtual keys    are vendor specific.  For
  619.       information about bindings for virtual buttons and keys, see
  620.       _V_i_r_t_u_a_l_B_i_n_d_i_n_g_s(_3_X).
  621.  
  622.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  623.       _C_o_m_p_o_s_i_t_e(_3_X), _C_o_n_s_t_r_a_i_n_t(_3_X), _C_o_r_e(_3_X), _X_m_C_h_a_n_g_e_C_o_l_o_r(_3_X),
  624.       _X_m_D_i_s_p_l_a_y(_3_X), _X_m_G_a_d_g_e_t(_3_X), and _X_m_S_c_r_e_e_n(_3_X).
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.      Page 10                        (printed 11/11/03)
  658.  
  659.  
  660.  
  661.